Release 10.1A: OpenEdge Development:
Progress 4GL Reference

LOAD( ) method

Loads an XML document into memory, parses it, and makes its contents available in the 4GL.

Return type: LOGICAL

Applies to: X-document object handle

Syntax

LOAD( mode , { file | memptr | longchar } , validate )

mode

A character expression that evaluates to one of the following: “FILE”, “MEMPTR”, or “LONGCHAR”.

file

A character expression that represents the name of a file. You can specify a relative pathname, an absolute pathname, or an HTTP URL.

memptr

A MEMPTR variable that contains the loaded XML text. The size of the MEMPTR variable should match the size of the XML text.

longchar

A LONGCHAR variable that contains the loaded XML text. The size of the LONGCHAR variable should match the size of the XML text.

validate

A logical expression where TRUE indicates that the parser should validate the document’s logical structure with respect to its Document Type Definition (DTD). Note that even if validation against the DTD is not specified, the document’s physical structure is still validated. If this expression is TRUE, then the parser will also validate against any XML Schema file references in the XML document or specified in the SCHEMA-LOCATION and NONAMESPACE-SCHEMA-LOCATION attribute.

Note

This method sets the ENCODING attribute for the XML document to the encoding name specified in the XML document’s encoding declaration.

Example

The following code fragment creates a parse tree of XML nodes and validates its structure:

DEFINE VARIABLE hDoc AS HANDLE. CREATE X-DOCUMENT hDoc. hDoc:LOAD("file","memo.xml",true). . . .

See also

ADD-SCHEMA-LOCATION( ) method, NONAMESPACE-SCHEMA-LOCATION attribute, SCHEMA-LOCATION attribute, SCHEMA-PATH attribute